.TH E1432_SET_CAL_VOLTAGE 3 E1432
.SH NAME
.nf
e1432_set_cal_voltage \- Set calibration DAC voltage
e1432_get_cal_voltage \- Get current value of calibration DAC voltage
.fi
.IX e1432_set_cal_voltage(3) 3
.IX e1432_get_cal_voltage(3) 3
.SH SYNOPSIS
.cS
SHORTSIZ16 e1432_set_cal_voltage(E1432ID hw, SHORTSIZ16 ID,
                                 FLOATSIZ32 cal_voltage)
SHORTSIZ16 e1432_get_cal_voltage(E1432ID hw, SHORTSIZ16 ID,
                                 FLOATSIZ32 *cal_voltage)
.cE
.SH DESCRIPTION

\fIe1432_set_cal_voltage\fR sets the E1432 internal calibration DAC
voltage, of a single channel or group of channels \fIID\fR, to the
value given in \fIcal_voltage\fR.

\fIe1432_get_cal_voltage\fR returns the current internal calibration
DAC voltage, of a single channel or group of channels \fIID\fR, into a
memory location pointed to by \fIcal_voltage\fR.

This parameter is a "global" parameter.  It applies to an entire E1432
module rather than to one of its channels.  The \fIID\fR parameter is
used only to identify which module the function applies to, and all
channels in that module will report the same value for this parameter.

\fIhw\fR must be the result of a successful call to
\fIe1432_assign_channel_numbers\fR, and specifies the group of
hardware to talk to.

\fIID\fR is either the ID of a group of channels that was obtained with a
call to \fIe1432_create_channel_group\fR, or the ID of a single channel.

\fIcal_voltage\fR determines the voltage to set.  The valid range
depends on the setting of the \fIcalin\fR parameter (see
\fIe1432_set_calin\fR).  If \fIcalin\fR is E1432_CALIN_DC_LO, then the
valid range is -0.4838 to +0.4835 volts.  For any other value of
\fIcalin\fR, the valid range is -15 to +14.9927 volts.

This specified voltage is converted to the appropriate calibration DAC
setting, and the DAC is set using \fIe1432_set_cal_dac\fR.
.SH "RESET VALUE"
After a reset, \fIcal_voltage\fR is set to \fB0\fR.
.SH "RETURN VALUE"
Return 0 if successful, a (negative) error number otherwise.
.SH "SEE ALSO"
.na
e1432_set_calin, e1432_set_cal_dac, e1432_set_source_output,
e1432_set_sumbus
.ad
